Inside Macintosh: Mac OS 8 Toolbox Reference /

Chapter 7 - Finder Interface Reference / Finder Interface Functions

Routing Files /

GetFolderRoutings

NEW WITH MAC OS 8

Gets folder routing information from the global routing list.

pascal OSErr GetFolderRoutings (
                     UInt32 requestedRoutingCount,
                     UInt32 *totalRoutingCount,
                     Size routingSize,
                     FolderRouting *theRoutings);

requestedRoutingCount

On input, the number of folder routing structures that can fit in the buffer pointed to by the theRoutings parameter.

totalRoutingCount

On output, a pointer to the number of folder routing structures in the global list. If this value is less than or equal to requestedRoutingCount, all folder routing structures were returned to the caller.

routingSize

On input, the size (in bytes) of the folder routing structure; see "The Folder Routing Structure".

theRoutings

Pass a pointer to a buffer containing one or more folder routing structures on output. If nil was passed, then only the total count of types will be returned in the totalRoutingCount parameter.

function result

A result code; see "Result Codes".

SPECIAL CONSIDERATIONS

Finder does not currently honor changes to the global folder routing list. Descriptions of some folder routing features are provided at this time for informational purposes only.